home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr42 / wowii130.zip / WOWIIE.DOC < prev   
Text File  |  1993-04-19  |  41KB  |  1,218 lines

  1.  
  2.  
  3.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  4.  
  5.  
  6.  
  7.                                WOWII Version 1.30
  8.                             Module Player for the PC
  9.  
  10.                       "Introduction to the World Of Music"
  11.  
  12.  
  13.      Contents:
  14.  
  15.         I. What the hell IS WOWII?
  16.  
  17.        II. What do I need to use WOWII properly?
  18.  
  19.       III. I want to know how it sounds like!!!
  20.  
  21.        IV. More information for the uninterested... (Or: How It Works)
  22.  
  23.            1.) Commandline Options
  24.  
  25.            2.) WOWII.INI - Optionsfile
  26.  
  27.            3.) Keyboardcommands
  28.  
  29.         V. Basic Information
  30.  
  31.            1.) "Communication between WOWII and SoundBlaster" - The Audio DMA
  32.  
  33.            2.) "WOWII looks cool!!" - The 'Tweaked' Video Mode
  34.  
  35.            3.) "WOWII does not like managers" - Why you should not use EMM
  36.  
  37.            4.) "Lovelife of Modules" - Portrait of a well-known format
  38.  
  39.        VI. 'Hostile' Environments or "What WOWII can cope with"
  40.  
  41.            1.) Windows 3.0, 3.1
  42.  
  43.            2.) Desqview 2.31
  44.  
  45.            3.) OS/2 2.0
  46.  
  47.       VII. Copyright, Copyright and ... Copyright!
  48.  
  49.            1.) The Shareware Idea
  50.  
  51.            2.) CrippleWare? What is that?
  52.  
  53.            3.) What am I allowed to do exactly?
  54.  
  55.            4.) What could I do more?
  56.  
  57.            5.) "Do I WANT to do more?" - Philosophical Excursions
  58.  
  59.            6.) Copyrights and Restrictions in short!
  60.  
  61.  
  62.  
  63.  
  64.    Translation: T. Meyer             Page 1                     July 19, 1992
  65.  
  66.  
  67.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  68.  
  69.  
  70.      VIII. How To Register Easily
  71.  
  72.        IX. Other things
  73.  
  74.            1.) The All Important Address
  75.  
  76.            2.) Acknowledgments
  77.  
  78.            3.) Some history, sources and other blah
  79.  
  80.         X. Afterword
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                All mentioned Trademarks and Copyrights are
  121.                   registered by their respective owners.
  122.  
  123.              This manual was formatted with PROFF written by
  124.                        Ozan S. Yigit & Steven Tress
  125.  
  126.  
  127.  
  128.    Translation: T. Meyer             Page 2                     July 19, 1992
  129.  
  130.  
  131.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  132.  
  133.  
  134.    I. What the hell IS WOWII?
  135.    ──────────────────────────
  136.  
  137.           WOWII is  a  program that plays four-voice musicfiles on an
  138.         IBM PC (or compatible).  
  139.  
  140.           With WOWII  it  is  possible  to  play  any Soundtracker or
  141.         ProTracker  "Module"  on  the  PC. These so-called "Modfiles"
  142.         originate  on  the  Commodore  Amiga  homecomputer  and serve
  143.         mostly  as  background or title tunes for games or demos. The
  144.         modules  owe  their  popularity to their excellent sound that
  145.         is  achieved by four independant digital channels.  WOWII can
  146.         only  play  modules  through the Soundblaster or Soundblaster
  147.         Pro soundcard.  
  148.  
  149.  
  150.  
  151.    II. What do I need to use WOWII properly?
  152.    ─────────────────────────────────────────
  153.  
  154.           A Soundblaster  (Pro) card is absolutely necessary in order
  155.         for  WOWII to work. On the Soundblasters 1.0, 1.5 and 2.0 the
  156.         music   is   being   played  in  mono,  but  WOWII  uses  the
  157.         Soundblaster   Pro's   stereo  mode  for  even  better  sound
  158.         quality.  
  159.  
  160.           Because the  output  of four digitized voices requires lots
  161.         of  processing  power,  the  minimal configuration is a 80286
  162.         AT.  You  will  be  able  to customize WOWII to the computing
  163.         capacities   of   your  specific  computer.  Additionally,  a
  164.         Standard-VGA graphics card is necessary.  
  165.  
  166.           And last,  but  not  least,  you  will  need  some modules.
  167.         Soundtracker  and  ProTracker  modules  are available on many
  168.         BBSes  and  at  Public  Domain  dealers.  "Modfiles" are very
  169.         popular,  so  it  should  be  no  problem for you to put your
  170.         hands on a few.  
  171.           If you  still  have  problems  getting  them,  you can also
  172.         contact  me.  For  a few bucks I will search my collection of
  173.         around 600 modules and copy a few of them for you.  
  174.  
  175.  
  176.  
  177.    III. I want to know how it sounds like!!!
  178.    ─────────────────────────────────────────
  179.  
  180.           If all  requirements mentioned under II. are fulfilled, you
  181.         are  absolutely  ready  to  enjoy  the  pleasure of digitally
  182.         reproduced music.  
  183.  
  184.           The following recommendations should be followed: 
  185.           - The  files  WOWII.EXE  and  WOWII.PIC must be in the same
  186.             directory.  
  187.           - The  parameter  /I:x must be the interrupt number of your
  188.             Soundblaster (Pro) card.  
  189.  
  190.  
  191.  
  192.    Translation: T. Meyer             Page 3                     July 19, 1992
  193.  
  194.  
  195.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  196.  
  197.  
  198.  
  199.                                   *WARNING*
  200.  
  201.             If  you  do  not  specify  the  IRQ  number  and your
  202.             Soundblaster  is configured to any other IRQ than IRQ
  203.             5,  WOWII  will  refuse to work. If this happens, you
  204.             will  possibly have to reset your computer (switch it
  205.             off,  if  necessary). Do this, if WOWII still refuses
  206.             to  play  the  module,  even  when  you specified the
  207.             correct IRQ this time.  
  208.  
  209.           Example: You  want  to play the module "AXEL-F.MOD" and the
  210.         Soundblaster   is   configured  to  use  interrupt  number  7
  211.         (factory   setting).  You  should  start  WOWII  on  the  DOS
  212.         commandline as follows: 
  213.  
  214.                 WOWII /I:7 axel-f 
  215.  
  216.           The ".MOD"  extension  will  be automatically appended; the
  217.         order   of   the   parameters  "/I:7"  and  "axel-f"  is  not
  218.         important.  
  219.  
  220.           When you  press  the  [Return]-key  the  screen  blanks and
  221.         after   a  brief  moment  you  will  see  a  display  with  4
  222.         oscilloscopes  and 4 peakmeters. If you do not see this, your
  223.         system  has  no VGA compatible graphics card installed or the
  224.         parameters were incorrect.  
  225.  
  226.           To quit  the program, you will have to press the [Esc]-key.
  227.         A  few informational texts appear and you will be returned to
  228.         the DOS commandprompt.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.    Translation: T. Meyer             Page 4                     July 19, 1992
  257.  
  258.  
  259.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  260.  
  261.  
  262.    IV. More information for the uninterested... (Or: How It Works)
  263.    ───────────────────────────────────────────────────────────────
  264.  
  265.      1.) Commandline Options
  266.      ───────────────────────
  267.  
  268.           WOWII has  lots  of  commandline options and will interpret
  269.         them  correctly  (most of the time). The order of them is not
  270.         important,  WOWII  tries  very  hard  to  figure out what you
  271.         mean.  
  272.  
  273.           A quick  reference  of  all  options  WOWII  understands is
  274.         printed when you call WOWII *without* any option.  
  275.  
  276.           Example: 
  277.  
  278.         C:\MODFILES>WOWII [RETURN]
  279.         WOWII Version 1.30 SOUNDBLASTER(PRO) MODPlayer Copyright (c) ...
  280.         Usage: WOWII MODFile[.MOD] [/H:xxxx] [/I:x] [/B:xxxxx] [/PRO] ..
  281.                /H:xxxxx defines the output frequency.
  282.                /I:x specifies the IRQ of the SOUNDBLASTER.
  283.                /B:xxxxx defines the size of the DMA-Buffer (1000-31000).
  284.                /PRO enforces the SOUNDBLASTER Pro.
  285.                /SB enforces the normal SOUNDBLASTER.
  286.                /FLT enables the output filter of the SOUNDBLASTER PRO.
  287.                /S start program with unRealtime Spectrum Analyzer.
  288.  
  289.         C:\MODFILES>
  290.  
  291.           This reference  can  be displayed anytime this way, to ease
  292.         the usage of WOWII.  
  293.  
  294.  
  295.      a.) Short reference of commandline options
  296.      ──────────────────────────────────────────
  297.  
  298.           /H:xxxxx specifies  the  output  frequency.  Allowed values
  299.         are between 6000 to 22000 Hz.  
  300.  
  301.           /I:x specifies   the   interrupt   number   (IRQ)   of  the
  302.         Soundblaster.  The  factory setting of the card is IRQ 7, but
  303.         if  you  experience  problems with other hardware components,
  304.         values  2,  3,  5  and  10  can  be used also.  (Consult your
  305.         Soundblaster  manual  if  you  are  not  sure about the right
  306.         IRQ.) 
  307.  
  308.           /B:xxxxx specifies  the  size  of  the  DMA-buffer. Allowed
  309.         values are between 1000 and 31000 bytes.  
  310.  
  311.           /PRO forces  stereo  output  on the Soundblaster, *even* on
  312.         the Soundblasters 1.0, 1.5 and 2.0.  
  313.  
  314.           /SB forces   mono   output   on   all   versions   of   the
  315.         Soundblaster.  
  316.  
  317.  
  318.  
  319.  
  320.    Translation: T. Meyer             Page 5                     July 19, 1992
  321.  
  322.  
  323.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  324.  
  325.  
  326.           /FLT enables the highpass-filter of the Soundblaster Pro.  
  327.  
  328.           /S displays  a  "(un)RealTime  Spectrum  Analyzer"  in  the
  329.         lower part of the display instead of the 4 oscilloscopes.  
  330.  
  331.  
  332.      b.) In-depth description
  333.      ────────────────────────
  334.  
  335.           The option  /H:xxxxx  specifies  the  output  frequency  in
  336.         Hertz.  The  higher  the  frequency,  the  more  data must be
  337.         output and of course calculated per second.  
  338.           A frequency  of  22KHz requires a lot more processing power
  339.         than  a  frequency  of 16KHz. The default frequency is 16 KHz
  340.         and  should  fit  normal  quality  demands.  When  using  the
  341.         highest  frequency of 22 KHz, even fast computers like an IBM
  342.         386DX  with  25MHz  are  at  the  peak  of  their capacities.
  343.         Specifying  an  output  frequency  that  is too high for your
  344.         computer  results  in  short  interruptions  or pauses during
  345.         play.  
  346.           If you  experience  any of these problems, you will have to
  347.         decrease  the  output  frequency  or  use  the  "(un)Realtime
  348.         Spectrum Analyzer" instead of the 4 oscilloscopes.  
  349.  
  350.           The option  /I:x specifies the Soundblaster IRQ. You should
  351.         choose  this parameter with utmost care because a wrong value
  352.         will  "crash"  the  Soundblaster  card,  and a reboot of your
  353.         system will be necessary.  
  354.  
  355.           The option  /B:xxxxx  specifies the size of the DMA-buffer.
  356.         WOWII  uses  a  variable sized memoryarea for the transfer of
  357.         the  audio  data.  Parts of the digital music are stored here
  358.         and are being played by the Soundblaster itself.  
  359.           The bigger  the buffer, the longer the delay after pressing
  360.         special  keys,  e.g.  Fast  Forward,  Rewind,  or  muting the
  361.         channels.  
  362.           The smaller  the  buffer,  the  more often the Soundblaster
  363.         must  be  told  to  play  the memoryarea, which results in an
  364.         undesired effect (see V.1.).  
  365.           The advantage  of  specifying  a  small  buffer is that the
  366.         delay after keypresses shortens.  
  367.  
  368.           The option  /S  forces  WOWII  to display the "(un)Realtime
  369.         Spectrum  Analyter" right from the start of the program. This
  370.         display  uses  less processing time than the 4 oscilloscopes,
  371.         so   you  can  squeeze  some  more  Hertz  out  of  a  slower
  372.         computer.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.    Translation: T. Meyer             Page 6                     July 19, 1992
  385.  
  386.  
  387.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  388.  
  389.  
  390.      2.) WOWII.INI
  391.      ─────────────
  392.  
  393.           The WOWII.INI  file  can  be used to store default options.
  394.         All  options  mentioned  under  IV.1.  may  be used, but only
  395.         *one*  option  on  a line.  WOWII.INI must reside in the same
  396.         directory as WOWII.EXE and WOWII.PIC! 
  397.  
  398.           Example for WOWII.INI: 
  399.  
  400.       ────────────────────────────────────────────────── cut here
  401.       ; WOWII.INI  Copyright (c) 1992  Jan Ole Suhr
  402.       ; Commands:
  403.       ; modfile[.mod] Name of module.
  404.       ; /I:x          Specifies Soundblaster IRQ (default of WOWII is 5).
  405.       ; /H:xxxxx      Output frequency in Hertz (14000-23000).
  406.       ; /B:xxxxx      Specifies the size of the DMA-buffer (1000-31000default)
  407.       ; /PRO          Forces Soundblaster Pro stereo mode, even on the
  408.       ;               normal Soundblasters.
  409.       ; /SB           Forces the Soundblaster into mono mode.
  410.       ; /FLT          Enables the filter of the Soundblaster Pro.
  411.       ; /S            Starts WOWII with the "Spectrum Analyzer".
  412.       /I:7
  413.       /H:18000
  414.       ────────────────────────────────────────────────── cut here again
  415.  
  416.           Please note  that lines starting with a semicolon (";") are
  417.         interpreted  as  remarks. The example sets the Soundblaster's
  418.         Interrupt as IRQ 7 and the output frequency to 18KHz.  
  419.  
  420.  
  421.      3.) Keyboardcommands
  422.      ────────────────────
  423.  
  424.           WOWII allows  the  user  to  manipulate the reproduction of
  425.         the  music  in  many ways. You can activate many options that
  426.         influence the music directly or indirectly.  
  427.           The keyboard  routine  was  implemented  in a way that even
  428.         simultaneous  keypresses  are  recognized  correctly  and are
  429.         even handled simultaneously most of the time.  
  430.           Due to   the   output  method  via  DMA  (see  also  V.1.),
  431.         keypresses  that have a direct effect on the music output can
  432.         be  delayed  to  up  to  2  seconds.   This delay is directly
  433.         affected by the size of the DMA-buffer.  
  434.  
  435.           I have  the  following  recommendation  for  keys  that are
  436.         marked with a (X) below: 
  437.           Be patient.  If  the  desired  effect  is  not  experienced
  438.         immediately,  one  is  normally  tempted  to  press  that key
  439.         again.  This  results  in  the  deactivation of the according
  440.         option, so do not fall from your chair because of surprise.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.    Translation: T. Meyer             Page 7                     July 19, 1992
  449.  
  450.  
  451.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  452.  
  453.  
  454.      a.) Basic keys for program interaction
  455.      ──────────────────────────────────────
  456.  
  457.           [Esc] (X) : Press the Escape-Key to quit WOWII.  
  458.  
  459.           Cursor down/Cursor   up  :  Switches  from  the  instrument
  460.         display  to the oscilloscope/analyzer display and vice versa.
  461.         Pressing  the  key  while  the screen is still scrolling will
  462.         immediately scroll back.  
  463.  
  464.           [Return] :  Pressing the Return-key will switch the display
  465.         from   the   oscilloscopes   to  the  "(un)RealTime  Spectrum
  466.         Analyer"  and vice versa.  [Return] is ignored during fade-in
  467.         and -out.  
  468.  
  469.           T :  Switches the timer from playing time to remaining time
  470.         and vice versa.  
  471.  
  472.  
  473.      b.) Basic keys controlling the music output
  474.      ───────────────────────────────────────────
  475.  
  476.           Cursor left  (X)  :  Rewind. "Rewinds" the music very fast.
  477.         Some  Soundtracker/ProTracker  modules behave somehow strange
  478.         during  rewind,  but  these  complications  do  not last very
  479.         long.  If  WOWII reaches the beginning of the module it halts
  480.         there.  
  481.  
  482.           Cursor right  (X) : Fast Forward. "Fast Forwards" the music
  483.         very  fast.   If WOWII reaches the end of the module, it will
  484.         exit automatically.  
  485.  
  486.           The output  volume  is reduced to half of the original when
  487.         rewinding or fast forwarding! 
  488.  
  489.           [Pos1] (X) : Jumps to the beginning of the module.  
  490.  
  491.           Shift+[F1]..[F10] :  Stores  the  actual  position  on that
  492.         function key (i.e. the Track, see V.6.).  
  493.  
  494.           [F1]..[F10] (X)  :  Jumps to the previously stored Track in
  495.         the  module.   If no position has been stored on the function
  496.         key, nothing will happen.  
  497.  
  498.           1..4 (X) : Mutes the according channel.  
  499.  
  500.           P :  Stops  the  output  immediately. Be careful when using
  501.         this on multitasking-systems. The computer may crash.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.    Translation: T. Meyer             Page 8                     July 19, 1992
  513.  
  514.  
  515.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  516.  
  517.  
  518.    V. Basic Information
  519.    ────────────────────
  520.  
  521.      "1.) "Communication between WOWII and SB" - DMA and other stuff
  522.      ───────────────────────────────────────────────────────────────
  523.  
  524.           In difference  to  other Module-Players like MP (ModPlay by
  525.         Mark  J.  Cox), WOW (oohh, from meeee) or SPP (Super Pro Play
  526.         by  Joshua  C.   Jensen),  WOWII uses the DMA-Transfer of the
  527.         Soundblaster (Pro) for digital output.  
  528.           The main  reason  for  using DMA is that it is the ONLY way
  529.         to play stereo digital sound on the Soundblaster Pro! 
  530.           Compared to WOW, WOWII is a completely new program.  
  531.  
  532.           Additionally, DMA  (Direct  Memory  Access)  has some other
  533.         important advantages: 
  534.  
  535.           By using  DMA,  the  processor  is free to do other things,
  536.         while   the   Soundblaster   outputs   the  data  by  itself.
  537.         Data-transfer  from memory to the Soundblaster card is almost
  538.         transparent.  This  way,  the  processor  can  calculate  the
  539.         digital    data,    while    the   Soundblaster   reads   the
  540.         pre-calculated  data  from memory and writes it to the analog
  541.         output.  
  542.  
  543.           Due to   this   method,   some   difficulties   during  the
  544.         development of WOWII were encountered: 
  545.           The processor  calculates  the  data, before it is actually
  546.         played.  This is done by a process called "double-buffering".
  547.         The  data  that  was calculated is written to a buffer, while
  548.         another  buffer  which  has  been  filled  before,  is  being
  549.         played.   Once  the  "Play"-buffer  was  fully  read  by  the
  550.         Soundblaster, the buffers are exchanged and so on.  
  551.           This is   very   easy,   but   if   some  graphical  output
  552.         corresponding  to  the  audio  output  is desired, things get
  553.         complicated.  The  visual representation of the music must be
  554.         synchronized  to  the  previously  calculated audio data. For
  555.         this  purpose  WOWII  uses  an  interrupt that is produced in
  556.         cyclic intervals by the Soundblaster's hardware.  
  557.  
  558.           Another almost  unsolvable problem occurs when one tries to
  559.         synchronize the music to keyboard commands.  
  560.  
  561.           If a  key  gets  hit  that effects the music directly, this
  562.         happens: 
  563.           At the  time  of  the key being hit, the Soundblaster plays
  564.         one  of  the precalculated buffers. So the wanted effect, for
  565.         example  Fast  Forward,  will  not  be  heard until the other
  566.         buffer is being played, which can be up to 2 seconds later.  
  567.  
  568.           The long  delay  can  be  shortened by specifying a smaller
  569.         DMA-buffer,  so  that  buffers  are switched more often. This
  570.         again  yields  a  very special disadvantage that gets further
  571.         explained in V.3.  
  572.  
  573.  
  574.  
  575.  
  576.    Translation: T. Meyer             Page 9                     July 19, 1992
  577.  
  578.  
  579.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  580.  
  581.  
  582.  
  583.      2.) "WOWII looks cool!!" - The 'Tweaked' Video Mode
  584.      ───────────────────────────────────────────────────
  585.  
  586.           WOWII uses  an  undocumented  videomode of the standard VGA
  587.         graphics   card  for  it's  display.  This  mode  supports  a
  588.         resolution   of   320x240   pixels   in  256  colors  with  a
  589.         pixelresolution  of  1:1  and  is  an  improvement  over  the
  590.         standard   256   color  mode  with  320x200  pixels.  Another
  591.         advantage is the possibility of more than one screen pages.  
  592.           Although this  videomode  is undocumented, all standard VGA
  593.         graphics cards should support it.  
  594.  
  595.           Multitaskingsystems like  Windows, DesqView (/X) or OS/2 do
  596.         not  store  the  attributes  of  the videomode correctly when
  597.         switching  to  another application. This is not WOWII's fault
  598.         of  using  an  "undocumented" videomode, but the programmers'
  599.         of  these  systems  who  seem  to be uncapable of storing the
  600.         visual environment of the tasks correctly.  
  601.  
  602.  
  603.      3.) "WOWII does not like managers" - Why you should not use EMM
  604.      ───────────────────────────────────────────────────────────────
  605.  
  606.           First let  me  say  that  WOWII works very well with memory
  607.         managers.  It is even capable of using High Memory Areas (HMA
  608.         -  regions  of memory beyond the 640K boundary) as instrument
  609.         buffers.   To  enable  this  feature,  the  installed  memory
  610.         manager must confirm to the XMS-Interface-Standard.  
  611.           If WOWII  would not work with installed memory managers, it
  612.         would  not  be  possible  to  run  WOWII  under  multitasking
  613.         environments like Windows, DesqView or OS/2.  
  614.  
  615.           But there  is  still  a  problem,  which  I  am  tempted to
  616.         conceal, but it is not my fault, so here we go...  
  617.  
  618.           Memory managers  are  switching  80386/486  processors into
  619.         the  Protected Mode and mimic a normal 8086 to the OS MS-DOS.
  620.         This  mode  of  operation  is  called  Virtual  V86-Mode  and
  621.         improves the processing speed of certain operations.  
  622.           Due to  the principal of this mode, interrupts and commands
  623.         that  access  the  hardware of the PC must be emulated by the
  624.         memory  manager. These emulations are slower than without the
  625.         manager and delays or general loss of speed is unavoidable.  
  626.  
  627.           The problem  with WOWII is now as follows: The Soundblaster
  628.         generates  an interrupt when the processing of the DMA-buffer
  629.         is  finished  (IRQ  2,  3, 5, 7 or 10). The interrupt handler
  630.         now  has  the  chance  to  start  the  playing  of  the other
  631.         buffer.  
  632.           The delay  between  the  occurance of the interrupt and the
  633.         playing  of  the  following  buffer seems to be enhanced by a
  634.         memory  manager.  The  result  is  a  short  silence  between
  635.         DMA-buffers,  which  can  be  heard  in  quite  modules  as a
  636.         "bubbling" or "klicking" noise.  
  637.  
  638.  
  639.  
  640.    Translation: T. Meyer            Page 10                     July 19, 1992
  641.  
  642.  
  643.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  644.  
  645.  
  646.           This problem  is  well-known  and  is  experienced in *any*
  647.         software  using  DMA-transfer with installed memory managers.
  648.         Some  module  players  do  struggle  especially hard with the
  649.         problem   of   choosing   a   small  DMA-buffer  and  thereby
  650.         increasing the occurance of this "bubbling".  
  651.  
  652.           WOWII can  be  customized  to  your  needs in specifying an
  653.         appropriate buffersize.  
  654.           The largest   buffersize   of  31000  bytes  takes  exactly
  655.         31/15.5  =  2  seconds  when  being  played  in  mono  with a
  656.         frequency  of  15.5KHz.  The  "bubbling"  (if any) will occur
  657.         only every 2s.  
  658.  
  659.           This annoying  effect only creeps up in very quiet modules.
  660.         A short pause is easily heard.  
  661.  
  662.  
  663.      4.) "Lovelife of Modules" - Portrait of a well-known format
  664.      ───────────────────────────────────────────────────────────
  665.  
  666.           Sadly this has not been a very investigated topic yet...
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.    Translation: T. Meyer            Page 11                     July 19, 1992
  705.  
  706.  
  707.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  708.  
  709.  
  710.    VI. 'Hostile' Environments or "What WOWII can cope with"
  711.    ────────────────────────────────────────────────────────
  712.  
  713.      1.) Windows 3.0, 3.1
  714.      ────────────────────
  715.  
  716.           Using WOWII  with  Windows only yielded a few problems. You
  717.         should  not  switch  tasks  when  WOWII  is  playing  because
  718.         Windows  obviously  is  not able to restore WOWII's videomode
  719.         correctly.  Retests  have  shown, that Windows 3.0 IS capable
  720.         of  restoring  the videomode, but NOT Windows 3.1. See? Don't
  721.         blame me! 
  722.           Special care  must  be  taken when using the 'P'(ause)-Key.
  723.         WOWII  calls  a Soundblaster command to stop the DMA-transfer
  724.         immediately   and   it   caused  all  3  tested  multitasking
  725.         environments to crash.  
  726.           Other applications   may   well  continue  working  in  the
  727.         background while WOWII is playing.  
  728.           Remember to  start  WOWII  in  a  full DOS screen - it will
  729.         definitely  not  work  in a window. This applies to all other
  730.         multitasking systems, too.  
  731.  
  732.  
  733.      2.) DesqView 2.31
  734.      ─────────────────
  735.  
  736.           Most problems  mentioned  under 1.) apply to DesqView, too.
  737.         Restoring  the videomode when switching back to WOWII is more
  738.         an  attempt  of  killing  the  monitor than having the wanted
  739.         effect.  
  740.           You should  definitely  avoid  switching  tasks, which also
  741.         applies  to  using  the  Pause-key, which most likely crashes
  742.         DesqView.  
  743.  
  744.           WOWII has  now  been tested under DesqView/X also, with the
  745.         same  result.   DesqView/X  cannot even restore the videomode
  746.         of  WOWII,  but crashes immediately. DO NOT switch tasks when
  747.         WOWII is playing.  
  748.  
  749.  
  750.      3.) OS/2 2.0
  751.      ────────────
  752.  
  753.           As far  as  testing has gone, OS/2 2.0 seems to be the best
  754.         multitasking  system  for DOS, Windows and OS/2 applications.
  755.         OS/2  is  able  to run WOWII as a foreground task, too. On an
  756.         IBM  AT  386 compatible computer with 33 MHz WOWII could play
  757.         a  module  with  22KHz  effortlessly  while  the OS/2 mailbox
  758.         system Maximus BBS did it's work in the background.  
  759.           But due  to  it's advanced videomode WOWII even pushes OS/2
  760.         2.0 to it's limits.  
  761.           As yet  it is unexplained why WOWII ignores some keypresses
  762.         when running under OS/2.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.    Translation: T. Meyer            Page 12                     July 19, 1992
  769.  
  770.  
  771.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  772.  
  773.  
  774.         [ And Now For Something Completely Different ]
  775.  
  776.    VII. Copyright, Copyright and ... Copyright!
  777.    ────────────────────────────────────────────
  778.  
  779.      1.) The Shareware Idea
  780.      ──────────────────────
  781.  
  782.           Shareware are  programs  that  were  put  together by hobby
  783.         programmers  and  that  are  not  distributed  via commercial
  784.         channels  (e.g.  a  Software  Publisher).  Due  to this, most
  785.         authors  release  versions of their programs that are more or
  786.         less  usable  and  may  be freely distributed. These versions
  787.         are  spreading  very  fast  most  of  the  time  and make the
  788.         program known to a lot of users.  
  789.           By 'registering'  the  program,  the  user will get a fully
  790.         functioning  version of the program. To do this, the user has
  791.         to send the author some money.  
  792.  
  793.           If a  programmer  receives lots of registrations he will be
  794.         convinced  to  put  a  lot  more  effort into the program, in
  795.         order to satisfy the users who registered.  
  796.           Should the  programmer  receive  very  few registrations he
  797.         will  most  likely get deep depressions which can result in a
  798.         very   strange   behaviour.   Some  authors  have  even  gone
  799.         commercially.  
  800.  
  801.  
  802.      2.) CrippleWare? What is that??
  803.      ───────────────────────────────
  804.  
  805.           Shareware programs  lacking  so  many  features  that  they
  806.         become useless to the user are called CrippleWare.  
  807.           The crippling  of his software is the programmer's only way
  808.         of  guaranteering it's protection from being copied like hell
  809.         with  him not getting any rewards. The distance from bearable
  810.         to  unbearable  restrictions is very narrow. But think of the
  811.         programmer  who is getting word of his program being used far
  812.         more often than he has received registrations...  
  813.  
  814.           The 'Era  Of  Trust'  in the software business has vanished
  815.         long ago - if it ever existed.  
  816.  
  817.           Gone are  the  times  when  one  was programming to receive
  818.         acknowledgment  and  praise.  But  there  is  still  a lot of
  819.         idealism  in Shareware, which to lose would mean the end of a
  820.         great idea.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.    Translation: T. Meyer            Page 13                     July 19, 1992
  833.  
  834.  
  835.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  836.  
  837.  
  838.      3.) What am I allowed to do exactly?
  839.      ────────────────────────────────────
  840.  
  841.           WOWII is  a  Shareware  program.  This yields the following
  842.         rules: 
  843.  
  844.           You are  allowed  to  test  WOWII  for a period of 4 (four)
  845.         weeks  after  receipt,  to  see  if it fits your needs. After
  846.         this  period  you  are  not  allowed  to  use the program any
  847.         further.  
  848.  
  849.           Whoever gets  himself  another  testversion of WOWII to get
  850.         himself  another  four weeks of testing incurs penalty ( ever
  851.         seen a PC disintegrating to stardust? ).  
  852.  
  853.           Beware! At   the  moment  I  am  rendering  my  alternative
  854.         service and have the right to legal remedy. Yeeeeaaaahhh! 
  855.  
  856.           WOWII may  be  freely distributed, even after expiration of
  857.         the testing period.  
  858.  
  859.           Even Shareware-Distributors    or    dealers,    who    are
  860.         distributing  Shareware  by  mail,  may  put  WOWII  in their
  861.         collection.   The   same  is  valid  for  other  distribution
  862.         channels,  e.g.  'Bildschirmtext'  or  'Channel Videodat' and
  863.         other  electronic  online  services. But I would like to send
  864.         me  a  note  if you do this, so I do not get annoyed by calls
  865.         like  "I  got  your  program from BTX, why didn't you include
  866.         any modules?" - "Huh???".  
  867.  
  868.           WOWII may  not  be used commercially in the testing period.
  869.         This  includes  single  sale and bundling with other soft- or
  870.         hardware.   Exceptions may be granted after contacting me. If
  871.         I agree, I will send you a written permission.  
  872.  
  873.           WOWII may  be  used  for  display  purposes, as long as the
  874.         source of the program can be recognized unmistakably.  
  875.  
  876.           WOWII may  not  be  modified  and  this  is  valid  for the
  877.         distribution  archive,  too. This includes adding advertising
  878.         textfiles for BBS or something like that to the archive.  
  879.  
  880.           Disassembling WOWII  does  *not*  incur  penalty.  But when
  881.         using my routines, please state the original author.  
  882.  
  883.  
  884.      4.) What could I do more?
  885.      ─────────────────────────
  886.  
  887.           If you  register WOWII, you will receive a fully functional
  888.         and  unrestricted version. I offer an "updateservice" free of
  889.         charge,  which  guarantees  free new versions to the original
  890.         registrator.  It  is  for  the  user  to  get himself the new
  891.         version, either by mail or modem.  
  892.  
  893.  
  894.  
  895.  
  896.    Translation: T. Meyer            Page 14                     July 19, 1992
  897.  
  898.  
  899.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  900.  
  901.  
  902.           I am  planning  to  implement many new features into WOWII.
  903.         The  most important is an interactive interface, which allows
  904.         easy  selection  of  modules  instead  of  one  at  a time by
  905.         commandline.  
  906.           The development  of these features depends on the number of
  907.         registrations  I  will  receive. Also, I'm very interested in
  908.         ideas you may have.  
  909.  
  910.  
  911.      5.) "Do I WANT to do more?" - Philosophical Excursions"
  912.      ───────────────────────────────────────────────────────
  913.  
  914.           "I would  like  to express my deepest admiration to anyone,
  915.         who  can  live without WOWII after testing it for four weeks.
  916.         This  leads  me  to  the conclusion that there are still some
  917.         persons  out  there who can pull themselves together and keep
  918.         their  most  inner feelings and natural desires for play, fun
  919.         and  suspense  (version  2.0  in  the  handy  chocolate egg -
  920.         doesn't  melt  in  the hand, but on the modem's power supply)
  921.         under total control." 
  922.              - Jan Ole Suhr, 1992 
  923.  
  924.           Not everyone    is    into   registering   Shareware,   but
  925.         nonetheless  I would like to explain what my reception of the
  926.         Shareware idea is.  
  927.  
  928.           There are  loads  and  loads  of Shareware authors, who are
  929.         scattered  all  over  the  world.  They  deliver high-quality
  930.         software  to a wide range of users and many of their products
  931.         reach  the  quality  standard of commercial products and some
  932.         are  even  better.  Most of these programming ideas could not
  933.         be   realized   by   the  'big'  software  companies,  but  a
  934.         corresponding  market  for the Shareware is non-existant. The
  935.         Biggies  are  busy  enough  handling their own brand products
  936.         and  are  scared  of  investing  into  other projects. On the
  937.         other  hand,  the  small  software  companies do not have the
  938.         appropriate  distribution  channels and so they specialise on
  939.         individual solutions, that are paid for very good.  
  940.           When a  Shareware author takes the role of a 'lifeguard' of
  941.         innovation  and  does not get support from the *users*, it is
  942.         very frustrating.  
  943.           And it  is  getting  very  annoying  when  one has to argue
  944.         about  absolutely  rediculously  low  fees, whose value often
  945.         only cover the author's expenses.  
  946.  
  947.  
  948.      6.) Copyrights and Restrictions in short!
  949.      ─────────────────────────────────────────
  950.  
  951.           The program  WOWII  Version  1.xx  is  copyrighted  and was
  952.         evidently  developed by Jan Ole Suhr. Who ever spoils my soup
  953.         by  taking  my  code  without  credit  will  get  his stomach
  954.         emptied by me, ok? 
  955.  
  956.           Restrictions? Good  heavens,  these  were mentioned already
  957.  
  958.  
  959.  
  960.    Translation: T. Meyer            Page 15                     July 19, 1992
  961.  
  962.  
  963.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  964.  
  965.  
  966.         in VII.3.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.    Translation: T. Meyer            Page 16                     July 19, 1992
  1025.  
  1026.  
  1027.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  1028.  
  1029.  
  1030.    VIII. How To Register Easily
  1031.    ────────────────────────────
  1032.  
  1033.           Those who  want  to  get  WOWII  without  a  timelimit  and
  1034.         nerving texts, should contact the nice and needy author: 
  1035.  
  1036.           Please send  a  self-addressed  envelope  (not  stamped), a
  1037.         disk  of  current  format  and  20  US  Dollars (or the equal
  1038.         amount  in  your  currency)  in  notes  or  a collection-only
  1039.         check,  plus  a  short  note  stating "Order of WOWII" to the
  1040.         author: 
  1041.  
  1042.                 Jan Ole Suhr 
  1043.                 Bockhorster Weg 28 
  1044.                 2806 Oyten 
  1045.                 Germany 
  1046.  
  1047.           I urge  you to note your name and address on an extra piece
  1048.         of  paper,  so  I  can  easily  verify  the  authencity  of a
  1049.         registrator when I receive update requests.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.      Short addendum:
  1056.      ───────────────
  1057.           Of course  I  am very pleased when I receive disks with new
  1058.         modfiles.   But  please,  if you do, just send *one* disk. If
  1059.         the  resonance is as huge as it was with WOW, I will have all
  1060.         my  hands full handling the registrations and cannot fill all
  1061.         those disks with modules again.  
  1062.           Also, I  am very interested in any new innovations in music
  1063.         reproduction.  Those  who  program stuff like this themselves
  1064.         are encouraged to send it to me, too.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.    Translation: T. Meyer            Page 17                     July 19, 1992
  1089.  
  1090.  
  1091.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  1092.  
  1093.  
  1094.    IX. Other things
  1095.    ────────────────
  1096.  
  1097.      1.) The All Important Address
  1098.      ─────────────────────────────
  1099.  
  1100.           The author's address:
  1101.  
  1102.                 Jan Ole Suhr
  1103.                 Bockhorster Weg 28
  1104.                 2806 Oyten
  1105.                 Germany
  1106.  
  1107.           Tel.: 04207/2571      Guaranteed to be a voiceline!
  1108.                 04207/801033    Call this number after 25-May-1992
  1109.  
  1110.           Fido: Jan Ole Suhr, 2:241/2002.8
  1111.  
  1112.  
  1113.  
  1114.  
  1115.           A very nice local (german) BBS I visit very often:
  1116.  
  1117.                               FANTASIA BBS, Achim
  1118.  
  1119.                Line 1, 04202/84777 (U.S. Robotics Dual Standard)
  1120.                Line 2, 04202/84649 (U.S. Robotics Dual Standard)
  1121.  
  1122.         If you want to contact MnemoTroN, he can be reached thru InterNet as
  1123.                          i03a@alf.zfn.uni-bremen.de
  1124.  
  1125.  
  1126.      2.) Acknowledgments
  1127.      ───────────────────
  1128.  
  1129.           At first,  let  me  thank  my  betatesters  Michael Baekow,
  1130.         MnemoTroN  (Thomas  Meyer),  Mogwai (Roger Böhmermann), Harald
  1131.         Zappe, Michael Hesse, Daniel Meer and Markus Schwarz.  
  1132.           I am  especially  indebted  to  Michael  Baekow for testing
  1133.         WOWII   in   a   very  hard  and  intensive  way  (OS/2  2.0,
  1134.         Soundblaster Pro).  
  1135.           WOWII's almost  perfect  emulation  of  most of the effects
  1136.         from  the original Amiga ProTracker is due to the information
  1137.         provided  by MnemoTroN (Thomas Meyer). As he is the author of
  1138.         the  Soundtrackers  V2.3-V2.6  on  the  Amiga,  he  knows the
  1139.         material  very  well.  He  also  gave  me  the opportunity of
  1140.         listening  to  WOWII  on the Soundblaster Pro, thus awakening
  1141.         tremendous euphoria.  
  1142.  
  1143.           "The World Is Waiting" (tm) - MnemoTroN, 1992.
  1144.  
  1145.           Two other  persons  I  would  like to thank very deeply are
  1146.         Harald  Zappe,  who spared no expenses in order to provide me
  1147.         with   information   regarding   the   programming   of   the
  1148.         Soundblaster  Pro  and  Jim  Chun  Wah,  Software Engineer at
  1149.  
  1150.  
  1151.  
  1152.    Translation: T. Meyer            Page 18                     July 19, 1992
  1153.  
  1154.  
  1155.    WOWII V1.30                                Copyright (c) 1992 Jan Ole Suhr
  1156.  
  1157.  
  1158.         Creative  Labs,  Singapore,  who  helped  me  with a few very
  1159.         difficult problems.  
  1160.  
  1161.           I must  not  forget my friend Sven Rohde, who often bursted
  1162.         my   illusions   with   almost   unsolvable  suggestions  and
  1163.         improvement  ideas.  His  criticism  is appalling, but that's
  1164.         how it goes with "non-computing" friends.  
  1165.  
  1166.  
  1167.      3.) Some history, sources and other blah
  1168.      ────────────────────────────────────────
  1169.  
  1170.                              to be continued ...
  1171.  
  1172.  
  1173.  
  1174.    X. Afterword
  1175.    ────────────
  1176.  
  1177.           I would  like  to wish you much fun while testing WOWII and
  1178.         may no bugs be with you! 
  1179.  
  1180.           "I'm a man on a mission! - WOW(II)" - Jan Ole Suhr, 1992.
  1181.  
  1182.                   Bye, bye and don't forget to register ;-)
  1183.  
  1184.                                 Jan Ole Suhr
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.         P.S.  : Thanks to mom & dad for proof-reading this document! 
  1193.         P.P.S.: Many  thanks  to  MnemoTroN for translating the whole
  1194.                 document  into  English.   [No problem, it was fun...
  1195.                 NOT! :-) MTN] 
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.    Translation: T. Meyer            Page 19                     July 19, 1992
  1217.  
  1218.